home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d26 / frames.arc / FRAMES.DOC < prev    next >
Text File  |  1989-11-26  |  10KB  |  331 lines

  1.  
  2.  
  3.                                      Frames
  4.  
  5.  
  6.                         A Computer-Aided Instruction Tool
  7.                                      v. 1.0
  8.  
  9.  
  10.                                   User's Guide
  11.  
  12.  
  13.                        Copyright (c) 1989 by timothy weber
  14.                                   P.O. Box 6721
  15.                                 Ithaca, NY 14851
  16.                                  (607) 277-5301
  17.  
  18.                                  GEnie: T.WEBER4 
  19.                               GC4Y@CORNELLA.BITNET
  20.  
  21.  
  22.  
  23.  
  24.               Portions Copyright (c) 1988 by Philip A. Mongelluzzo
  25.                              Waterbury, Connecticut
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      
  64.                                                                p.1
  65.  
  66.  
  67.  
  68.  
  69.      INTRODUCTION
  70.  
  71.           This manual describes how to use Frames, a tool for Computer-Aided
  72.      Instruction (CAI).
  73.  
  74.           Frames implements something known as "programmed textbooks" on the
  75.      computer.  Specifically, it presents the student with small bits of
  76.      material, called "frames," and requires the student to fill in words or
  77.      phrases that have been left out.
  78.           The concept is not as complex as other CAI methods; it doesn't
  79.      provide hints, respond to wrong answers with explanations, grade the
  80.      student's progress, take different paths through the lesson, or use
  81.      graphics or sound.  It simply asks the student to fill in the blanks,
  82.      and shows the right answers when she has completed all the blanks on a
  83.      frame.
  84.           This has been done in paper textbooks for many years.  What Frames
  85.      does that paper doesn't do is:
  86.  
  87.           1. Allow the teacher to monitor a student's progress easier,
  88.                eliminating paper records or standardizing them
  89.           2. Allow a library to distribute unlimited copies of a book easily
  90.                and cheaply, and reduce paper waste
  91.           3. Give program authors an easy way to create on-line tutorials,
  92.                with little time and money.
  93.  
  94.           What Frames does that other CAI programs don't do is:
  95.  
  96.           1. Provide a simple user interface for the student
  97.           2. Provide a simple user interface for the teacher.
  98.  
  99.  
  100.      SHAREWARE
  101.  
  102.           Frames is marketed as User-Supported Software.  This means that
  103.      you are free to copy it, try it, and pass it along to any and everyone,
  104.      but you are expected to pay the author $30 if you use it.  In exchange
  105.      for this registration fee, you will get the most recent version of the
  106.      program, and you will be notified when upgrades are made.
  107.           To register, print out the invoice included with Frames by typing
  108.      "copy invoice.doc prn" at the DOS prompt, fill it out, and send it to
  109.      me with a check or money order.
  110.           Please note that you may NOT receive any money in exchange for a
  111.      copy of this program, above the nominal cost of copying, and you MUST
  112.      copy all the files together and AS IS.
  113.  
  114.  
  115.      SYSTEM REQUIREMENTS
  116.  
  117.           Frames has been tested on a PC-XT compatible with 640K RAM and a
  118.      Color/Graphics adapter, running DOS 3.1.
  119.           Note that future versions are planned to work identically on the
  120.      Apple Macintosh family, and support is planned for the Microsoft Mouse.
  121.      If you're interested in these, let me know.
  122.  
  123.  
  124.      DISTRIBUTION DISK
  125.  
  126.  
  127.  
  128.  
  129.      
  130.                                                                p.2
  131.  
  132.  
  133.  
  134.  
  135.           The following files are on the distribution disk:
  136.  
  137.                FRAMES.EXE       the executable file
  138.                TUTORIAL.FRA     frame file for the tutorial
  139.                FRAMES.DOC       documentation (this file)
  140.                INVOICE.DOC      invoice
  141.                AHED.COM         The Ad Hoc Editor, by Michael Covington
  142.                AHED.TXT         The Ad Hoc Editor documentation
  143.  
  144.  
  145.      FRAME FILES
  146.  
  147.           In order to use Frames, you must first enter the information that
  148.      you want presented to your students.  The exact format of this
  149.      information, referred to as the "frame file," is detailed below.
  150.           There are three main restrictions on frame files:
  151.  
  152.           1. The names of frame files must have an extension of ".FRA".
  153.           1. Frame files must be placed in the directory that is the current
  154.                directory when Frames is run.  If you need more information
  155.                about directories or file names, see your DOS manual.  (If
  156.                all your files are on one floppy disk, this probably won't be
  157.                a problem.)
  158.           2. You must create them with an editor or word processor that
  159.                creates "ASCII" or "flat" files.  If you don't have such an
  160.                editor, you can use AHED, the "Ad Hoc Editor" [1], included
  161.                with Frames.
  162.  
  163.  
  164.      RUNNING FRAMES
  165.  
  166.           To start Frames, simply type "Frames" at the DOS prompt.  You will
  167.      receive instructions on how to load a tutorial on using Frames.  All
  168.      the information you need to know to use Frames is contained in this
  169.      tutorial; you should read it before continuing to the next section of
  170.      this User's Guide, so you will understand the terms used there.
  171.  
  172.  
  173.      FRAME FILE FORMAT
  174.  
  175.           Entering frames is very simple: just type the text you want to
  176.      appear.  It doesn't matter where your margins are set or how the text
  177.      is formatted in the file; Frames will reformat it so that it fits on
  178.      the screen.  For example, the file TUTORIAL.FRA (the frame file for the
  179.      tutorial) has a right margin at 60, but when you look at it with
  180.      Frames, it fills the whole width of the screen.
  181.           Note that you can edit TUTORIAL.FRA with AHED or your favorite
  182.      ASCII editor to see examples of all the frame file format rules.  This
  183.      is recommended.
  184.  
  185.           To indicate how you want your text divided into frames, place a
  186.      period (".") on a line by itself in the first column.  For example:
  187.  
  188.  
  189.  
  190.  
  191.      _________
  192.      1. This is an independent product written and distributed by Michael
  193.      Covington, and is not a part of Frames.  You may use it free of charge.
  194.      For more information, see the AHED.TXT file.
  195.      
  196.                                                                p.3
  197.  
  198.  
  199.  
  200.  
  201.                ---------------------------------------------------
  202.                This is a sample frame file.
  203.                This is its first frame.
  204.                .
  205.                This is its second frame.
  206.                ---------------------------------------------------
  207.  
  208.           To separate a frame into one or more paragraphs, place a colon
  209.      (":") on a line by itself in the first column, like this:
  210.  
  211.                ---------------------------------------------------
  212.                This is another sample frame file.
  213.                This is its first frame, the first paragraph.
  214.                :
  215.                This is its second paragraph of the first frame.
  216.                .
  217.                And this is the second frame.
  218.                ---------------------------------------------------
  219.  
  220.           By default, Frames numbers all frames and all paragraphs after the
  221.      first.  This is so you can use the first frame or the first paragraph
  222.      of a frame as an introduction or title.
  223.           If you want the numbering to start at some number other than one,
  224.      put the number right after the "." or the ":", like this:
  225.  
  226.                ---------------------------------------------------
  227.                This frame will have no number.
  228.                :
  229.                This paragraph will be numbered "1."
  230.                :5
  231.                This paragraph will be numbered "5."
  232.                .597
  233.                This frame will be numbered "597."
  234.                ---------------------------------------------------
  235.  
  236.           Also, if you don't want your paragraphs or your frames numbered at
  237.      all, you can put a "0" after the "." or the ":", like this:
  238.  
  239.                ---------------------------------------------------
  240.                This frame will have no number.
  241.                :0
  242.                This paragraph will have no number.
  243.                :
  244.                This paragraph will be numbered "1."
  245.                .0
  246.                This frame will have no number.
  247.                ---------------------------------------------------
  248.  
  249.  
  250.      ENTERING BLANKS
  251.  
  252.           To enter a multiple choice blank in the frame file, you need to:
  253.  
  254.           1. Put parentheses () around the choices,
  255.           2. Separate them by slashes /, and
  256.           3. Indicate the correct answer by putting an asterisk * in front
  257.                of it.
  258.  
  259.           For instance:
  260.  
  261.      
  262.                                                                p.4
  263.  
  264.  
  265.  
  266.  
  267.                ---------------------------------------------------
  268.                This statement is (true/false/*don't know).  The
  269.                correct answer is "don't know".
  270.                ---------------------------------------------------
  271.  
  272.           To put a fill-in blank in the frame file, just put an underscore
  273.      character ("_") before and after it, like this:
  274.  
  275.                ---------------------------------------------------
  276.                This sentence has a _fill-in blank_.  The correct
  277.                answer is "fill-in blank".
  278.                ---------------------------------------------------
  279.  
  280.           You can also have fill-in blanks with multiple correct answers,
  281.      like this:
  282.  
  283.                ---------------------------------------------------
  284.                This sentence has a _blank/fill-in blank_.  The two
  285.                correct answers are "blank" and "fill-in blank".
  286.                ---------------------------------------------------
  287.  
  288.           The only restrictions on blanks are that they cannot be longer
  289.      than 80 characters so they can fit on one line of the screen, and they
  290.      cannot be broken across lines.  If you break a blank across lines, it
  291.      will be seen as just plain text.
  292.           Again, there are more examples of both multiple choice and fill-in
  293.      blanks in TUTORIAL.FRA.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      
  328.                                                                p.5
  329.  
  330.  
  331.